<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title></title>
  <meta name="Generator" content="Cocoa HTML Writer">
  <meta name="CocoaVersion" content="949.54">
  <style type="text/css">
    body {background-color: #FFFFFF}
    p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 26.0px Helvetica}
    p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
    p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
    p.p4 {margin: 0.0px 0.0px 12.0px 0.0px; font: 12.0px Helvetica}
    p.p5 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Times; min-height: 14.0px}
    span.s1 {text-decoration: underline ; color: #0000fb}
  </style>
</head>
<body>
<p class="p1"><b>Building a Cecilia Interface</b></p>
<p class="p2">graphical interface controls.</p>
<p class="p3"><br></p>
<p class="p2"><b>DESCRIPTION</b></p><br>
<p class="p4">Cecilia allows you to control Csound with a series of creative widgets. Widgets are GUI controllers 
	defined in the interface panel of the Cecilia editor using a simple syntax. </p>
<p class="p4">In the interface panel, you can define a list of widgets you wish to add to the Cecilia interface. 
	Widget definition starts with its type, followed by a variable name so that its value can be retrieved in the orchestra. 
	The definition ends with a series of flags and values parameterizing the widget. Each widget has a different set of flags 
	depending on its behaviour. Some flags are compulsory, others are optionals. One widget is defined per line but a widget 
	definition can take more than one line if each intermediate line ends with a double backslash (<b>\\</b>).</p>
<p class="p4">A widget's value is transfered to the Csound orchestra using the widget's global variable. This means you can 
	retrieve a widget value in your orchestra using a standard <i>gkvariable_name</i> or <i>givariable_name</i> 
	syntax (slightly different for the crange).<span class="Apple-converted-space"> </span></p>
<p class="p4"><b>WIDGET TYPES</b></p>
<p class="p2">- <a href="./cbutton.html"><span class="s1"><b>cbutton</b></span></a>: a trigger button.</p>
<p class="p2">- <a href="./cfilein.html"><span class="s1"><b>cfilein</b></span></a>: an input file menu.</p>
<p class="p2">- <a href="./cgen.html"><span class="s1"><b>cgen</b></span></a>: a text-field for function table generation.</p>
<p class="p2">- <a href="./cgraph.html"><span class="s1"><b>cgraph</b></span></a>: a graph line.</p>
<p class="p2">- <a href="./cpoly.html"><span class="s1"><b>cpoly</b></span></a>: a polyphony manager.</p>
<p class="p2">- <a href="./cpopup.html"><span class="s1"><b>cpopup</b></span></a>: a popup (contextual) menu.</p>
<p class="p2">- <a href="./crange.html"><span class="s1"><b>crange</b></span></a>: a range slider.</p>
<p class="p2">- <a href="./csampler.html"><span class="s1"><b>csampler</b></span></a>: a multichannel sampler with cross-fade looping.</p>
<p class="p2">- <a href="./cslider.html"><span class="s1"><b>cslider</b></span></a>: a horizontal slider.</p>
<p class="p2">- <a href="./ctoggle.html"><span class="s1"><b>ctoggle</b></span></a>: a checkbox.</p>
<p class="p5"><br></p>
<p class="p4"><b>SCRIPTING</b></p>
<p class="p4">In Cecilia, it is also possible to do scripting in the score editor. Scripting is based on Python. For more informations:
 <a href="./pythonScripting.html"><span class="s1"><b>Python Scripting</b></span></a></p>
<p class="p3"><br></p>
<p class="p3"><br></p>
<center><p class="p3">Return to <a href="./usingCecilia.html">Using Cecilia</a> section</p></center>
</body>
</html>
